home *** CD-ROM | disk | FTP | other *** search
/ Best of Shareware / Best of PC Windows Shareware 1.0 - Wayzata Technology (7111) (1993).iso / mac / ZIPPED / DOS / GRAPHICS / FRCAL040.ZIP / README.DOC < prev    next >
Text File  |  1993-04-15  |  13KB  |  255 lines

  1.     ┌──── ┌────┐ ┐           Timothy Harris
  2.     │     │    │ │           5 Burnham Park Road
  3.     │     ├────┤ │           Peverell
  4.     └──── │    │ └───        Plymouth,
  5.     ─────        ────        ENGLAND, PL3 5QB
  6.           v4·00              THarris@UK.AC.PLYM.SC
  7.  
  8. To execute CAL type `CAL' with the current directory set to the one in
  9. which the CAL.EXE, CAL.OVR and CAL.CFG files reside. CAL will run on a
  10. floppy-disk-only machine but copying all the files to the hard drive and
  11. executing them from there (run `INSTALL.BAT' to do this for you) will allow
  12. for quicker access to the help information.
  13.  
  14. CAL is public domain and you are therefore encouraged to give copies of it
  15. to other people - however these copies must be in an unmodified form and
  16. any charge made must be for media and distribution costs only.
  17.  
  18. The latest version is available from me on receipt of a blank disk and SAE,
  19. or a cheque for £2·20 - remember to specify what type of disk you are using.
  20.  
  21. Hardware requirements:
  22.  
  23. CAL will work on almost any machine described as `PC-Compatible that
  24. uses the DOS operating system. A maths coprocessor is not required but,
  25. if fitted, will allow images to be created several times more quickly.
  26. All operations can be performed using the keyboard, although using a mouse
  27. is easier for many operations. Calculations can be performed more
  28. accurately and more quickly on machines fitted with a 386sx processor
  29. or better, but the program is still compatible with older machines.
  30.  
  31. Improved image quality is available with super VGA graphics cards offering
  32. 256 colours from a palette of 262144. Provision will be made for the new
  33. cards allowing 32768 colours on the screen at once as soon as I can get
  34. hold of the technical specifications of such a card. 
  35.  
  36. Due to the large size of the program, and the fact that the computer only
  37. stores part of it in memory at once, CAL is best used running from a hard
  38. drive. If this is not possible, but around 2MB of expanded or extended
  39. memory is available, install the RAMDRIVE.SYS utility supplied with DOS
  40. (see DOS reference guides) and run CAL from the ramdrive. CAL can use 
  41. expanded memory for storing pieces of the code, resulting in slight 
  42. improvements in execution speed. CAL does not require, nor does it
  43. use, extended memory.
  44.  
  45. Recent additions to CAL:
  46.  
  47. 1. CAL now automatically detects if a 386 processor (or better) is
  48.    being used and will use an improved integer arithmetic algorithm
  49.    if possible.
  50.  
  51. 2. Recently added fractal types:
  52.       - Sierpinski triangle
  53.       - L-Systems
  54.       - Composite images (this allows options such as loading a saved
  55.                    image in the form of a sphere or 3D landscape)
  56.       - Logistic equation and associated Julia sets
  57.       - Flip-Mandelbrot image
  58.       - Images from applying Newton's method to zⁿ-1=0
  59.       - Gumowski and Mira attractor
  60.       - Symmetrical attractors
  61.       - Quaternion Julia sets
  62.       - Gingerbread person
  63.  
  64.    A total of 21 fractals are now available from CAL - and the user defined
  65.    formula option can be used to create many more. 36 demonstration
  66.    user defined formulae are provided which show the range of functions
  67.    that are available and provide a basis for producing your own sets
  68.    of equations.
  69.  
  70. 3. A data compression algorithm is used for saving images, which means that
  71.    less disk space is usually required for keeping a collection of pictures.
  72.    Additionally a new option - save details only - has been added which
  73.    stores only the information needed to recreate the fractal (typically
  74.    around 1K) rather than the complete image.
  75.  
  76.    For details on these fractals, and any others that are available,
  77.    select the Current fractal types option from the Welcome to CAL! help
  78.    screen. This is available by pressing F1 as soon as CAL has loaded.
  79.  
  80. 4. A batch drawing mode has been added which will scan the disk for any
  81.    unfinished images and complete them. This can be used overnight, or
  82.    when the computer is not going to be used for a while, to finish off
  83.    any images that there was not time to complete in one go.
  84.  
  85. 5. Improvements have been made to the user defined formula option which
  86.    allows trigonometry to be performed on complex numbers. Formulae can
  87.    be changed without leaving CAL by using a built-in editor.
  88.  
  89. 6. The user defined formulae option has also been improved to allow fractals
  90.    such as the Henon Attractor (where individual points are plotted instead
  91.    of an image covering the whole screen) to be entered. Additionally,
  92.    fractal formulae created using Fractint and saved in an FRM file can be
  93.    imported to and exported from CAL.
  94.  
  95.    The functions available in the user defined formulae option have also
  96.    been increased. Along with standard arithmetic and trigonometric functions
  97.    are FLIP (used to swap the real and imaginary parts of a complex number),
  98.    ABS (which converts a negative number to a positive one, but keeps
  99.    positive numbers positive) and SIGN which returns is a number is
  100.    positive, negative or zero. See the example formulae in the user defined
  101.    formulae option for how these functions can be used.
  102.  
  103. 7. A faster Lyapunov algorithm is available which typically speeds up drawing
  104.    of this fractal by two to four times.
  105.  
  106. 8. Commonly used functions can be selected using hot-keys from anywhere in
  107.    the program.  Ctrl-D    -    Draw
  108.                  Ctrl-C    -    Continue
  109.                  Ctrl-Z    -    Zoom in
  110.                  Ctrl-P    -    Palette editor
  111.  
  112. 9. CAL.ICO is an icon for use with CAL if it is being run from Windows.
  113.  
  114. 10.CAL can now export images to the PCX file format, compatible with most
  115.    graphics editing / printing programs.
  116.  
  117. 11.The user interface for the fractal selection lists has been modified 
  118.    slightly - as in previous versions the cursor keys can be used to select
  119.    a fractal, but now it is also possible to type in the name directly
  120.    to choose it. In the case of User Defined Formulae, IFS fractals and
  121.    L-Systems the \ or / keys may be used, when the fractal list is on
  122.    screen, to call up the menu for adding, deleting or renaming formulae.
  123.  
  124. 12.The compilation of user defined formulae has been made significantly
  125.    faster and the addition of MIN and MAX functions allows for more
  126.    elaborate colouring. See the Internal Colouring examples in the list
  127.    of user defined formulae.
  128.  
  129. An introduction to CAL:
  130.  
  131. 1. As an introduction press Return as soon as CAL has loaded to draw
  132.    the default image. If your copy of the CAL files is the same as the
  133.    set that I distribute this should be the Mandelbrot set in the
  134.    256 colour 320x200 mode that is now supported on most computers. If
  135.    your machine will not use this mode then read the steps below about
  136.    configuring the program.
  137.  
  138. 2. Selecting the graphics resolution... All video cards allow for a
  139.    variety of types of display. On earlier models this may be a choice
  140.    between a low resolution (i.e. blocky) image with several colours
  141.    or a less blocky image in black and white. Later systems have been
  142.    capable of 16 colours and most new graphics cards are capable of
  143.    displaying 256 colours on the screen at once.
  144.  
  145.    The type of resolution and number of colours to use are chosen 
  146.    from the `Display mode' option in the `Configurations' menu. Menu
  147.    choices are made using the cursor keys to change the highlighted
  148.    option and return to select it. If you are using a monochrome display
  149.    and find the text lacks contrast then run cal by typing `CAL /M' which
  150.    will cause a black and white palette to be used in text modes. Full
  151.    colours will still be available (if your display supports them) when
  152.    drawing an image.
  153.  
  154.    There are four different types of graphics mode, each progressively
  155.    more advanced than the one before:
  156.  
  157.    CGA - one of the original graphics standards and only really included
  158.    for machines which do not support more modern displays or to provide
  159.    a quick overview of a detailed image. At best you can have four colours
  160.    on the screen and the image does appear very blocky. However, CGA modes
  161.    are present on almost all computers, including older portable machines.
  162.  
  163.    EGA - EGA allows sixteen colours to be used, although you do not have
  164.    control over them to the same degree as is present with later standards.
  165.    The resolution is also better - meaning that curves appear less blocky
  166.    and images are more detailed.
  167.  
  168.    VGA - VGA appears to the user as an extension to EGA which allows you
  169.    to use even higher resolution and to choose the colours that are used
  170.    from a palette of colours available from the graphics card.
  171.  
  172.    SVGA - Super VGA is present on most new machines and allows images to
  173.    be produced using 256 colours, allowing for such effects as gradual
  174.    shifts from one colour to another. The resolution available in SVGA
  175.    means that you can see a lot of detail in images but the extra
  176.    calculations needed to calculate this detail can slow down drawing.
  177.    If you are using SVGA modes you must tell CAL which make of graphics
  178.    card is inside the computer (see next section).
  179.  
  180. 3. Configuring the graphics card... It is necessary to set options
  181.    about which type of graphics card you are using before any images
  182.    may be created in a super VGA display mode. You can change the settings
  183.    at any time you want since all the configuration options are contained
  184.    within the CAL program itself.
  185.  
  186.    The type of graphics card is chosen in the `SVGA Card Type' option
  187.    in the `Options' menu. You should be presented with a list of 
  188.    about fourteen different types of display card. If the one that you 
  189.    have fitted is listed there (this is often shown immediately upon 
  190.    powering up the computer) then select that option and it will be 
  191.    stored in the configurations file. Note that there are differences 
  192.    between graphics cards by the same manufacturer (e.g. some Tseng 
  193.    cards work in different ways to others, even though the image on 
  194.    the screen appears the same), so it may be necessary to try each 
  195.    of the variations of the card listed.
  196.  
  197.    If you cannot find your card listed, or do not know what type of card
  198.    is fitted to the machine, then try each one in turn until you get
  199.    successful results. It is best to have a moderate resolution SVGA
  200.    mode selected during these tests (e.g. 640x480 with 256 colours) since
  201.    the better standardisation between manufacturers means that non-SVGA
  202.    modes will work with any graphics card.
  203.  
  204.    During configuration you may sometimes get a disjointed image. This
  205.    is caused by the similar - although not quite identical - methods of
  206.    accessing the graphics display employed by some manufacturers. Another
  207.    of the SVGA card types will probably give the correct image.
  208.  
  209. 4. The current fractal type to draw (e.g. Henon attractor, Mandelbrot
  210.    set etc...) is chosen from the `Select fractal' option in the
  211.    `Fractal' menu. Use the up and down cursor keys so that the arrow
  212.    points at the fractal that you would like to draw and press the
  213.    return key.
  214.  
  215. 5. Further details about using CAL are available using the context sensitive
  216.    help facilities. Press F1 at any time during the program and use the
  217.    cursor keys to highlight the topic on which you would like more
  218.    information before pressing return. The escape key will cancel the help
  219.    mode.
  220.  
  221. 6. Whilst drawing a fractal, S can be used at any time to store the image
  222.    on disk. It can be loaded at a later stage and continued - it is not
  223.    necessary to wait for the image to be complete before saving it.
  224.  
  225. Should you encounter any difficulties with CAL, if you have suggestions for
  226. improvements, new fractal algorithms you would like included in future
  227. versions or queries of any kind then do not hesitate to contact me.
  228.  
  229. Demonstration images:
  230.  
  231. Since complete images can be very large, demonstration pictures have
  232. been stored in a compressed for so that only the bare minimum of data
  233. is kept. To see the demonstration images, change to the directory in 
  234. which CAL resides and start CAL. Choose Batch Mode from the Load/Save
  235. menu and select Start. The images will be automatically drawn and
  236. saved. The Load option can then be used to load them again.
  237.  
  238. It is probably best to ensure CAL is correctly configured for your 
  239. graphics card before doing this - see above - because the demonstration
  240. images were designed to look best in a 256 colour VGA graphics mode. If
  241. this mode is not available then select the best possible resolution
  242. with the largest number of colours from the Display option in the
  243. Options menu. The demonstration images are called DEMO1.CGF, DEMO2.CGF
  244. etc... When drawing the demonstration images the currently selected
  245. display mode will be used.
  246.  
  247. Copies of CAL on larger capacity disks (720K upwards) may have additional
  248. images, which are already complete, supplied with them. These include
  249. examples of the Lyapunov fractal (this is very impressive, but can be
  250. slow to calculate without a co-processor) and composite image option.
  251. The latter shows the facilities for creating 3D-landscapes and moulding
  252. images onto a sphere.
  253.  
  254. Timothy Harris
  255.